빠른 시작

아래 예제를 통해 iwinv AI API를 바로 시작해보세요.

1. SDK 설치

# Python
pip install openai

# Node.js
npm install openai

2. 클라이언트 초기화

Python

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["IWINV_API_KEY"],
    base_url="https://ai-api.iwinv.kr/v1"
)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.IWINV_API_KEY,
  baseURL: "https://ai-api.iwinv.kr/v1",
});

3. 사용 가능한 모델 조회

허용된 모델 목록을 확인합니다.

cURL

curl https://ai-api.iwinv.kr/v1/models \
  -H "Authorization: Bearer $IWINV_API_KEY"

Python

models = client.models.list()
for model in models.data:
    print(model.id)

Node.js

const models = await client.models.list();
models.data.forEach(model => console.log(model.id));

4. 첫 번째 요청

Python

response = client.chat.completions.create(
    model="gemma4-26b",
    messages=[
        {"role": "user", "content": "안녕하세요!"}
    ]
)

print(response.choices[0].message.content)

Node.js

const response = await client.chat.completions.create({
  model: "gemma4-26b",
  messages: [{ role: "user", content: "안녕하세요!" }],
});

console.log(response.choices[0].message.content);

cURL

curl https://ai-api.iwinv.kr/v1/chat/completions \
  -H "Authorization: Bearer $IWINV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4-26b",
    "messages": [
      {"role": "user", "content": "안녕하세요!"}
    ]
  }'

5. 스트리밍 응답 테스트

응답을 토큰 단위로 실시간 수신합니다.

Python

with client.chat.completions.stream(
    model="gemma4-26b",
    messages=[{"role": "user", "content": "iwinv를 소개해주세요."}]
) as stream:
    for chunk in stream:
        content = chunk.choices[0].delta.content
        if content:
            print(content, end="", flush=True)

cURL

curl https://ai-api.iwinv.kr/v1/chat/completions \
  -H "Authorization: Bearer $IWINV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4-26b",
    "messages": [{"role": "user", "content": "iwinv를 소개해주세요."}],
    "stream": true
  }'

6. 기존 OpenAI 코드 마이그레이션

기존에 OpenAI를 사용하던 코드라면 두 줄만 변경하면 됩니다.

# 기존 OpenAI 코드
client = OpenAI(
    api_key="sk-...",     # 기존 OpenAI Key
)

# iwinv로 전환
client = OpenAI(
    api_key="sk-...",                               # ← iwinv API Key로 변경
    base_url="https://ai-api.iwinv.kr/v1"          # ← base_url 추가
)

팁

model 파라미터도 iwinv 모델 ID로 변경해야 합니다.
전체 모델 목록은 모델 지정 페이지를 참고하세요.